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set upon return from the device 
driver if an error occurred- 
TheACCUMlIlATOR 
contains the return code, 
$00 = No errors 
$27 = I/O error 
$28 = No device connected 
S2B = Write protect error 
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DIRECT USE OF THE DISKETTE DRIVE 



ProDOS Hardware Addresses 





OFF SWITCHES 


'ON'\SWITCHES 


BASK 




BASE 




SWITCH 


ADDRKSS 


KUNCTION 


ADDRESS 


FUNCXrON 


QO 


^am} 


Phase off 


$C0R1 


Phase on 


Ql 


$C082 


Phase 1 off 


$C0S3 


Phase 1 on 


Q2 


$C0S4 


Phased off 


$C0S5 


Phase 2 on 


Q3 


$(:ofi6 


Phase a off 


SC087 


Phase :^ on 


Q4 


iCQSH 


Drive off 


$C0S9 


Drive on 


Q5 


SC08A 


Select drive I 


SC08R 


Sele{^tdnve2 


Q6 


seme 


Shift data 

reg-ister 


$COHD 


[iOaddata 

refi^ister 


Q7 


$C08E 


Rf^ad 


scosr 


Writt? 



foiif Way Q6/Q7 Switches 



06 


Q7 


FUNCTION 


Off 


Off 


Enable read sequeneinR:. 


Off 


On 


Shift data rej^ister every four cycles 
while writing. 


On 


Off 


Check write pryWct and initialize 
sequencer for writing. 


On 


On 


Load data register every four cycles 
while writing. 



Addreu Rortgea For $1ob 



SLOT 


ADDRESS 


NUMBER 


RANGE 





$C0aO-$C08F 


1 


$C090-$C(WF 


2 


$C0AO-$C0AF 


3 


$COBO-$COBF 


4 


?COCO-$COCF 


5 


$CODO-$CODF 


G 


$C0EO-$C0EF 


7 


$C0FO-$COFF 



ponell 



Also Sm Pagw 6-2 to 6-3 



ProDOS Block Conversion Tkble for Disk cites 






T^HYSICAE. 
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<H-i^ 


0<J7 


TRACK i (HJS 


(>0S* 


OOA 


OOP 


00*.' 


O01> 


(XI E 


«)F 
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0]] 
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0]-^ 


015 


01ft 


(117 
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027 
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023 
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TRACK ]:► «AH 
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(J A A 
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TRACK K^ OBO 


OTil 
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flFl4 


OB,i 
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TRACK ]7 OHJ^ 
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OR A 
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one 
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riHK 
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Ot'J 
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(K'll 
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(JCB 


ruif 
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TRACK] A om 


0T>] 


ODl^ 


thDS 


oD^ 


0D5 


nil* 


0]>7 


TRACK] ft JlDH 


ODH 


i^HA 


ODB 


imc 


ODD 


(H>E 


(IDF 


TRACK U: flEi> 


OKI 


OK 2 


CIKS 


OEi 


OE!i 


0E6 


OF 7 


TRACK ]n DKS 


0£9 


OEA 


OER 
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OFT^ 
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(]t;>- 


TRACK ]E iiFi) 


OF I 


0F3 


rhp\=i 


OK-l 


OF,-^ 


OFC 


OFT 


TRACK IK flK« 


Of^T^ 


Oi-A 


Oft! 


OFC 


OFD 


OFE 


0?-K 


TRACK ytJ ItH) 


ItH 


liJ^ 


10:l 


U>i 


LOrn 


It^G 


107 


TRACK 21 lt>8 
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mn 
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I OF 
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IlL 
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c 


HHECTOHY HEADERS 


+0/1: Pnevious 




+S04 


STORAfiLTYPE 




block 


+S1C 


NAME LENGTH 










AGE 


+2/3: Next bio 


ck 


DIRECTORY M^nvTFc^^ 
NAME , < 15 BYTES) 


1 - 


1 




RESERVED (BBYTtS) 




^ 




CREATION 
DATE 




STOP 




*S1E 




TYPE 


$FI 
$E 


= VolDir 
= sLbdir 






CREATION 








*$2t 


TIME 










Where 1 - length 
of volufne name 
















VERSION 


















*J21 










DATE: VYYYYYYM MMMC 

TIME: OOOHHHHH OOMMr 
ACCESS 


JDDDD 


h^lN 

VERSION 


l^MMM 






*S22 


ACCESS 








BUS: 


ONBOOOWR 


















0- 


Destroy 


w- 


Wrire 




*$2a 


ENTRY 
LENGTH 










8 = 


Rename 
BacKup 


R- 


Rea(J 


^4 


ENTRIES 
PfR BLOCK 














t 






FILF 










■^t27 


COUNT 

1 






-- 







SAME AS VolDir 






BUMAP 








PARENT 








POINTER 
1 












POINTER 








TOTAL 






PARENT 




PARENT 




RIOCKS 

1 











ENTNUM 




ENTIEN 






VolOir 










SubDir 








poml2 


Mio5wP9ges4-6to4 


r-fl 



































FILE DESCRIPTIVE ENTRY 






STORAGE TYPE 
NAME_LENGTH 




STORAi 
TYPE: 


nImE (^S^^TESf _ ^ 


fILE 
TYPE 


FILE 


KEYBLOCKPOmTER 


type: 


BLOCKS IN LfSE 
1 




EOF MARK 




CREATE DATE 


DATE: 


CREATE TIME 


TIME: 
ACCESS 


VERSION 




BITS: 


mn 

VERSION 


AUX 
TYPE: 


ACCESS 


AUX TYPE 




MODIFY DATE 

1 




MCK3IFYTIME 




DIR HEAD POINTER 





$21 -Sapling 

$31 =Tree 

SDI -Dir 

Where I -length 
of volume name 

$04 =TXT 

$06 -BIN 

SOF =DIR 

£FD - VAR 
SFF =SYS 



YYYYYYYM MMMDDDDD 
OOOHHHHH OOMMMMMM 

DNBOOOWR 

D = Destroy W = Write 

N - Rename R - Read 

B =- Backup 

TXT- Record Len 

BIN^ 

BAS> Load Address 

VARJ 

SVS= Default Parms 
{$2000) 



A fsc 5fle PflJSi J . f 10 J ' f 3 



VOLUME BIT MAP 



01234567 S9 



Lit bit is 1, BJoch is tree 

0, Block is in u^ 
Volume Bit Map ior a Disk II diskette is in Block 6 and is 35 bytes in length. 



panor3 



AticSBePt^»4-S 



SYSTEM GLOBAL PAGE FORMAT 


AOOB CONTENTS 


ADOn 


CflNTENTS 


BFOO JMPtoMLi 


BF7A-7B Opminise 


BR)3 JMPtoSeFF6 


BF7C-7C1 0penlile7 


BF06 JWIP fo Date/Time Address 


BF7E-7F Open hie 8 


(orFTS if hO clock) 


GFeO-87 


Intcrruotatldresslable 


BF09 JMPto System Error 


BFeO-ei Prioriiyl 


BFOC JMPtu System Death 


BF82-33 Priorily? 


ePOF Sysiem Error number 


BFB4-85 Priority 3 


eFiO-2F Device Driver address latJle 


BFS6 87 Priorny4 


BF10-11 Slot reserved 


BFSa 


A register scivearea 


BF1M3 Slot 1. Drivel 


BFe9 


Xregrsrer^avearea 


BF14-15 Slot 2. Drivel 


BFeA 


YregisJersavearea 


BF16-T7 Slot 3, Drivel 


BFBB 


S register ^svearea 


BFie-l9 Slot 4, Drivel 


BFec 


P register savearea 


BF1A-1B Slot 5. Drivel 


BF^D 


Bank 10 byte (ROM/RAM) 


BF1C-1D Slot 6. Drivel 


BF8F-fiF 


Interrupt return address 


BF1E-1F Slot 7. Drivel 


6F90-91 


Date 


BF20-21 Slot reserved 


RF92-93 


Time 


BF22-23 Slot 1, Drive 2 


BFSA 


Current File Level 


BF24-25 Slot 2. Drive 2 


6F95 


Backup Bit 


BFZ6-27 /RAM 


RP96-97 


Currently Unused 


BF2e-29 Slot 4. Drive 2 


BF9& 


Machine ID byte 


BF3A-?B Slot 5. Drive 2 


BF99 


Slot ROM bit map 


BF2C-2D Slot 6. Drive 2 


BF9A 


Prefix Flag (0^ no Prefix) 


BF2E-2F Slot 7, Drive 2 


BF9B 


MLI active Flag 


BF30 Slot/Ofive last device 


BF9C-90 


Last MLlcall return 


BF31 CDui>t(-1) active devices 




address 


BF32-3F List of active devices (ID) 


6F9E 


MLIX register savearea 


BF40-4F Copyright Notice 


BF9F 


Mil V register gavearea 


BF50-55 Bank i n RAM tal 1 1 RQ (tFF|>8) 


BFAO CF 


Lang, card enlry/exil 


BF56-57 Terr porary storage (SFFSB) 




rou fines 


BF58-6F Bitmap low 4flK of memory 


BFD0-F3 


Interrupt entry/exit 

routines 

Stordgefor byleatSEOOO 


BF70-7F Open File buffer address 
lable 


BFF4 


BRO-71 Open tile 1 


BFF5 


Storage for byte at SDOOO 


BF72-73 Open file 2 


BFF6-F9 


CairSysrem Death (SD1F4) 


BF74-75 Open file 3 


BFFC 


Inierpreter minimum 
Version 

Inierpreter Version 
number 


eF76-77 Open file 4 
BF78-7S Open file 5 


BFFD 




BFFE 


KerrieJ minimum version 




BFFF 


Kernel version number 



MACHINE IDENTIFICATION BYTE ($BF98) 



00. 


. . 


IL 


01 


. . 


IT+ 


10. 


. . 


lie 


11 


. . 


\U emulation 


00. 


1 . . 


Future expansion 


01 


1 


Future expar>sion 


10 


1 . . 


no 


11 


1 


Futuie eitpar^sion 



pandU 



00 
01 
10 
11 



Aiio 3ee P^g^it ff-^ to H-a 



unused 

m 

64K 

128K 

Reserved 
. 0. no 80-column card 
. 1 . 80-coJurnn card 
. . no compatible clock 
. . 1 compatible clock 





Bl GLOBAL PAGE FORMAT 






ADDR CONTENTS 


ADDP CONTENTS 




BEOO JMPtoWARMDOS 


BE53 Number of command 






BE03 JMP to command parse 


BF54-55 PBITS[permiltfiri) 


BE06 JMP to user parser 


BE56-57 FfllTS (found) 




1 BEM JMPtoerroJhandfer 


BE5S-59 A keyword value 






BEOC JMP to error printer 


BE5A-5C B keyword vahjfi 






BEOF Error code number 


BE5D-5E E keyword value 






BE1CHF Output vectors 


GE5F 60 L keyword value 






BF?C^2F Input vectors 


BEei S keyword vslue 






BE3C^31 Current output vec 


BE62 D keyword value 






BE32-33 Current input vec 


BEe3-64 F keyword value 






BES'l-aS OuTpul intercept addr 


BE6£k66 R keyword value 






BE36-37 Input intercept addr 


BE67 V keyword value 






BE3a-3B STATE intercepts 


6E63-69 @ keyword value 






BE3C Defaurt^loi 


BE6A T keyword value 






BE3D Defaurt drive 


BE6B FR^/IN# slot value 






BE3E-40 A.X.Vsavearea 


BE6C-6D Pattinameladdr 






BE41 TRACE active llag 


BE6E-6F Pattiname2addr 






BE42 STATE (0=immediate) 


BE70 GOSYSTEIVIMLIinterf. 






BE43 EXEC active flag 


eE85 Last MLIcaU number 






BE44 READ active f tag 


BE86-87 Last MLI parmlist addr 






BE45 WRITE active flag 


6EA0 CREATE parmlist 






BF46 PREFIX active flag 


BEAC GET PREFIX parmlist 






BE47 DIRffle READ Hag 


BEAF RENAME parmlist 






BE48 not used 


BEB4 GETJFILEJNFO parmhst 






BE49 STRINGS space count 


BEC5 ONLINE parmlist 






BE4A Buffered wrile count 


BECB OPEN parmlist 






BE4B Command lire length 


BED1 SET_NEWLIWEparnnlist 






BE4C Previous character 


BEDS READ parmlist 






flE4D Open file coun! 


BEDD CLOSE parmfist 






BE^E EXEC tile closing flag 


BEDF reserved 






BE4F CATALOG line stale 


BEF5 JMFtoGETBUFF 






BE50-51 Eyternaicmd handler 


BEF8 JMPtoFREEBUFR 






BE52 C m fn a nd na me lengt h 


BEFB Original HIMEIW MSB 






COMMAND NUMBERS: 




00= external 07= EXEC 0E= BSAVE 15^ APPEND 1C= CATALOG 


01- IN# 06- LOAD OF- CHAIN 16- CREATE ID- RESTORE 


02= PR# 09= SAVE 1 0= C LOSE 1 7= DE L ETE T E= P OSI T1 N 


03- CAT OA- OPEN 11- FLUSH 18- PREFIX 


04= FRE 0B=READ 12= NOMON 19= RENAME 


05= RUN OC=SAVE 13- STORE 1A-UNLOCK 


06= BRUM 0D=BLOAD 14- WRITE IB- VERIFY 


PB*TS/FBrTS BIT ASSIGNMENTS: 


Seooo Prefix needed 50080 AD Keyword oK 


$4000 Slot number only S0040 B keyword ok 


$2000 Deferred command S0020 E keyword ok 


$1000 File name optional S0010 L keyword ok 


$0800 Create file $000B @ keyword Ok 


$0400 T keyword ok $0004 S or D ok 


$0200 Path 2 expected $000? F keyword ok 


$0100 Path 1 expected $0001 R keyword ok 


PQpi^l 5 Aiso Se# Pafl#s B-2 to 9-6 











MLI CALLS 

Dt'B f unct ion_cOde 
DW dddr Df_parm5 

On relurn carry flag set if 
error and A reg has return code. 



$40 : AUJd?^ 



a 


sw 








% 


J 


-iihLLb= 



Ml 



DeALLOCLJNTeHklUPt 



* Shaded fields are outputs only or 
do rot need tniiializatior. 




$i1 ; WRltE^^ 



n 



UNIT BITS- 
DSSS 0000 



RlKK^jWEff 



$82 get-time: 



NO PARAMETER LIST 



::ctoate;: 



ST 












RIIS- 
















fin 








HI : -vn. 


aio-uj. 
rvrf 






rPF 


i-f 





ACCESS: DNBOOOWFt 

FILE TVPEi (see next panel) 
AUX-TVPE: TXT=Rec Len 

BIN.BAS. VAR = Address 
STORACE TYPE: 

$01- Seedling 

S02— Sapling 

S03— Tree 

SOD— Di recto rv 
DATE: VYYYYYYM MMMDDDDD 
TIME: OOOHHHHH OOMMMMMM 
PATHNAME Buffer must start with 
one byte lenglh lo I lowed bv name 
[MSB oft) 



panel 6 



JfSoSeePflSesS 1 5 10^-55 




m- 






ADD* 


SSOF 

UhWb 


ACCFF.F. 






FI.E 






-liF- 


rVP: 






6ET_FIL^ INFO on VoJ Di r returns 
blocks or Volume in AUX_TrPE. 
blocks in use by all tiles in blocks 
used 



dNL(H£ 



SSf 


UNIT BITS: 
OSSSOOOO 


uhii p^UBCe 


or 
0000 OOOO 


^CRHFFf.n- 



Aisn Sm Pagsa fi-SSloS-^S 



FILE TYPES: 



$00 


TV PEL ESS 


$1B 


ASP 


SFD VAR 


$01 


BAD 


$EF 


PAS 


$Fe REL 


$04 


TXT 


^FO 


Added Comrnard 


$FF SYS 


$06 


BIN 


SFI-SFB 


User Defined 




$0F 


DIR 


SFA 


Integer B AS rc pgm 


All others are 


$19 


ADB 


$FB 


fnleger BASIC vars 


SOS Qriy or are 


SI A 


AWP 


$FC 


BAS 


reserved. 



P(3ror7 



Also See Pages 4- JO to* '30 



*c?:;i:i:i9^T|pwR)t;; 



■:!$Jcrr;;ii:;fiEt4*>i!>6P* 





*^l 













:$C8 dPElit 



uy 




iUUHbKO' 
h'hfdAUE 


H!E HOFeP 


^^ 





w?& wewune;:: 



n 



,$00 DISABLE 
fSFF MATCH 
i57F IGNORE 
MSB 



jtCA WEAb 



VH 




PthEHbNUl 
HLHKB 




ACtREKSr 
IftTABuFfEfl 


L[i*rH 

'■::::-'-W//////a 



::iiiibiBi::;::iy^iFi: 



ice m^dsE 



*FFHFMrF 
MLHHH 



::*e&::>;:PtU»t> 



:$cE;:::i::$£i^Afti<:i 



y^ 






ncrrWhCE 






UAFftt 
HFOU 


55 Cf 
lU'-FhP 




UIH 




i 


V////,fi 


7/M 


fi 



NEvifilEf^SJlW^ 



^&^ytmi!aiim 



. / ^ ■ ■ ■ ■ ■ ■ ■ ' ■ ■ ■ ■ ■ ■ / 




panors 



A\ii> SM P4^S 5' Jfl fo e-5< 



Tr:^^::-:::-:::':::-:-:! 



i*i»'::i:]siCTdBQir 



'*!^:':::i&^^^ 



iot;::::-GeTieQF-: 



;;$p9:::;;fi(6:tJBUF:: 



'/,' '/// ' ■ '/ 









MLI ERROR CODES 



500 No error 

501 I nva fid Mir fun Clio n 
$04 f n va I id parameter ecu r \ 
S^5 interrupt table fuli 

S27 i/0 error 

S?S N o d e V i ce CO nn ected 

S?B Write protecled 

$2E Votgme switched 

$40 invaiid palhname syntax 

$42 Too many files open 

$43 Invaiid REF NUIVI 

S44 NoneJ(i stent patii 

$45 Vol ume r ot mo u nted 

$46 Ffie not found 

$47 Duplicate file name 



S46 Diskfuil 

$49 Voi DiR fuli 

S4 A I nconi pati ble P roDO S version 

$4B Unsupported storage type 

S4C End of file 

S4D Position past EOF 

S4E Access error 

$50 File aiready open 
S5t File count bacf 
$52 Nota ProDOSdisk 
S53 Bad parameter 
S55 VCB overflow 
$56 Bad buffer ad dr. 
$57 Du p I icate vo fu me 
$5A Bad vol. bit map 



panel? 



A tso ^M Pfl^J $-S4 to ff-e 1 



